home *** CD-ROM | disk | FTP | other *** search
/ Image Compendium (Alt) / Image Compendium (1996)(P.I.E.).iso / viewer / pv / pvdoc.txt < prev    next >
Encoding:
Text File  |  1991-07-13  |  17.6 KB  |  525 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                                   PicView 1.3
  35.                                An Picture Viewer
  36.                Copyright 1989,1990 by Greg Thomas & Brad Mettee
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.      What is PicView?
  79.  
  80.            PicView is an picture viewer that offers features not found in
  81.      other viewers.  This is not the end all program (yet).  Other viewers
  82.      do offers some features that PicView does not, such as graphic
  83.      conversion.  Some of the 'deficiencies' of PicView will be added to
  84.      later releases.
  85.  
  86.            Currently PicView will read and display GIF, Colorix and MAC
  87.      formats.  We are currently working on implementing more formats,
  88.      notably compressed RIX files, PCX and Deluxe Paint LBM files.  Other
  89.      formats are being looked into, and will be implemented as we accrue
  90.      information on them.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.      What makes PicView different than these other viewers?
  97.  
  98.            Ahh glad you asked that question (you did ask that, didn't
  99.      you?)  Well, for starters, our biggest pride with this product is the
  100.      superb ADJUSTABLE palette animation.  A picture can be animated
  101.      through the entire palette, a portion of the palette, and through a
  102.      range of colors in the palette.  The effects of the animation must be
  103.      seen to be truly appreciated.
  104.  
  105.  
  106.            It also sports a very easy to use window interface that if not
  107.      for the complex animation capabilities, would preclude the need for
  108.      docs at all.  It uses very easy pop-down windows for all parameter
  109.      setting and selection very similar to the environments used in
  110.      Borland's Language's (Guess will have to look out for the look and
  111.      feel police.)
  112.  
  113.  
  114.            PicView supports ATI, Tseng, Trident, Video7, Paradise, C&T,
  115.      Everex, Cirrus, and Ahead A & B chipsets.  It will auto detect if
  116.      these adapters are installed, and adjust the mode selections (screen
  117.      size) accordingly.  Also, for you True Blue users, a special
  118.      360x480x256 mode is implemented for you to get almost SVGA perfor-
  119.      mance out of your motherboard VGA.  This will also work on all
  120.      register compatible VGA cards.  PicView currently does not (and most
  121.      likely won't ever) support standards less then VGA.  There are several
  122.      viewers on the market that support EGA and below, so it seemed rather
  123.      pointless since PicView's animation abilities are best done on VGA.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                           2
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.            Files contained in PicView.zip
  142.               PV.EXE            PicView executable file
  143.               
  144.               PVDOC.TXT         PicView documentation
  145.               
  146.               REGISTER.TXT      PicView registration form
  147.               
  148.               REVHIST.TXT       Revision History
  149.               
  150.               PICVIEW.GIF       PicView.gif is a gif file which 
  151.                                 demonstrates the viability of partial 
  152.                                 palette animation.  Using the random 
  153.                                 palette (any palette will do, but works 
  154.                                 best with random or plasma) set starting 
  155.                                 register to 92, and end register to 112.
  156.               
  157.               DATA.PIX          Data for laserline opening credits.
  158.  
  159.               WAVE1A.GIF        Wave1a.gif, boxesa.gif, and tunnela.gif have 
  160.               BOXESA.GIF        continuous smooth palettes making 
  161.               TUNNELA.GIF       experimentation of the default palette's 
  162.                                 possible settings.
  163.  
  164.               DEMO.BAT          Batch file which creates and demonstrates 
  165.                                 PicView's Slideshow abilities.
  166.  
  167.  
  168.      In the Works
  169.           Some of the features that PicView will be incorporating in
  170.           future releases are:
  171.                A script language for slideshow presentations.
  172.                Support for more file formats i.e. PCX, LBM, etc.
  173.                Mode lockout.
  174.  
  175.  
  176.  
  177.                          Getting Started with PicView
  178.  
  179.  
  180.           You can start PicView by either typing PV at the DOS prompt to
  181.      get into menu mode, or you can specify a filename or listfile from
  182.      the command line to immediately display a file or slideshow.
  183.  
  184.           When starting PicView in menu mode, a credit screen will pop
  185.      up.  By default, PicView starts in 50 line mode.  If you prefer, you
  186.      can start it with the command line option -25 or /25 to have it
  187.      default to 25 line mode.  Strike a key, and you will be in the file
  188.      selection window.  From the main menu, you have 4 choices, detailed
  189.      here.
  190.  
  191.      Note: If you get tired of viewing the laserline, you can delete the 
  192.            data.pix file and it will no longer display.
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                           3
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.        Info
  209.  
  210.             Pops up the opening credit screen.  (In case you get bored, or
  211.        want to know who wrote this contraption.)
  212.  
  213.  
  214.        File
  215.  
  216.              Pops up a sub menu used for file selection.
  217.  
  218.  
  219.  
  220.        Options
  221.  
  222.              Brings up a sub menu to select PicView's options.
  223.  
  224.  
  225.        Exit
  226.  
  227.              Exits the program. (That's a hard one to figure out, eh?)
  228.  
  229.  
  230.        Submenus have a varying number of selections that either pop up an
  231.        additional submenu, prompt you for data, or display a selected file. 
  232.        Submenu options will be detailed here.
  233.  
  234.  
  235.        File
  236.            
  237.            Select File(s)
  238.            
  239.                 This selection pops up a file selection window which allows
  240.            you to select the file to be viewed.  The window sports a scroll
  241.            bar to give you an indication of how far along you are in the
  242.            list of files.  There is a real file limit of 16,384 files that
  243.            can be read into the directory (assuming you have a 640k 
  244.            machine).  You can use first character selection to speed you
  245.            through your files. Hitting 'T' once will take you to the first
  246.            file beginning with T.  Hitting it again will take you to the
  247.            next and so on.  The list can be scrolled beyond the end or
  248.            beginning if scrolling in reverse.  When you find the file you
  249.            want to display, Hit the 'ENTER' key and it will be displayed. 
  250.            If viewing a MAC file, Home, End, PgUp, PgDn, up & down arrow
  251.            keys will scroll the picture.  After the file has been
  252.            displayed, strike any key to return to the file selection
  253.            window.  When you return, you will have the last file displayed
  254.            still highlighted.
  255.  
  256.             
  257.             File Type
  258.             
  259.                  This selection will pop up a little window that allows you
  260.             to select which type of file you wish to have in the selection
  261.             window above.  Currently your choices are, GIF, RIX, and MAC.
  262.  
  263.  
  264.  
  265.                                           4
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.        Options
  275.  
  276.            Screen
  277.            
  278.                 This will pop up a submenu allowing you to select which
  279.            screen mode you want the picture displayed in.  Depending on
  280.            your video adapter, you may not be able to select all of the
  281.            choices.  The Auto select option will let the program select the
  282.            best video mode for the picture to fit in.
  283.            
  284.            Note:  You can hot-key into this window with the F3 key.
  285.            
  286.  
  287.            Animate
  288.            
  289.                 This will pop up a window prompting you for data to control
  290.            the animation facilities of PicView.  The first data item you
  291.            are prompted for is whether or not you want animation on.  If
  292.            you select 'N', the window is dropped, and you are returned to
  293.            the next level up menu.  If you select 'Y', you are then
  294.            prompted for the direction, palette, starting and ending
  295.            registers, and depending on the palette selected, starting and
  296.            ending color data.  More detail will be covered on this topic
  297.            later.
  298.            
  299.            Note: You can hot-key into this window with the F4 key.
  300.            
  301.        Exit
  302.            
  303.            This selection returns you to DOS.  Optionally, you can hit the
  304.            escape key at any top level menu to return to dos as well.
  305.  
  306.  
  307.        Hot Keys
  308.            
  309.            Hot key access to menus are as follows:
  310.            
  311.            F3 - Pops up screen size selection window.
  312.            F4 - Pops up animate window.
  313.            F5 - Brings up PalView for selected file.
  314.            F6 - Displays the dimensions of the highlighted file.
  315.            Alt D - Deletes the highlighted file from your drive.
  316.            
  317.            The 'A' key while viewing a picture will cause animate to start
  318.            using the defaults, or the selections made when you last turned
  319.            animate on.
  320.  
  321.  
  322.              To start PicView with a filename, simply type PV filename. 
  323.        Extensions are optional, but if omitted, GIF is assumed.  Filename can
  324.        consist of a filename and optional path of up to 80 characters. 
  325.        PicView will then display the file and wait for a keypress (or an 'A'
  326.        key to begin animating the pic).  If you also specify a /r or -r on
  327.        the command line, PicView will display the image and exit leaving the
  328.        graphics mode intact.  This is useful for calling PicView from other
  329.        programs to display a graphic image.  When started with this option,
  330.        PicView will not animate.
  331.  
  332.                                           5
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.              To start PicView with a listfile, simply type PV @listfile. 
  343.        PicView will then read filenames from the listfile and display them in
  344.        a round robin fashion, in a continuous cycle (or until aborted with
  345.        the esc key).  Filenames in the listfile with no extension are assumed
  346.        to be GIF.  A list file can be generated as simply as typing, DIR >
  347.        LISTFILE.  No editing of the dir output is neccesary as anything not
  348.        valid is ignored.  The next release of PicView will have a more robust
  349.        script language to control delays and animation.
  350.  
  351.  
  352.        What is PalView?
  353.            
  354.                 PalView is a handy utility that will display on screen the
  355.            contents of all you palette registers.  For PalView to work, you
  356.            must have the file selection window open with a file
  357.            highlighted.  Then, hit the F5 key and your screen will change
  358.            to display the palette.  If animate is turned on, it will
  359.            animate the palette display.  Any key will return you to the
  360.            file selection window.  (This is useful for determining the
  361.            ranges of any smooth palette blends you may see in a picture.)
  362.  
  363.  
  364.             OK, Let me go into some details on the animation options, as
  365.        some of it can be a bit confusing.
  366.  
  367.  
  368.             After selecting 'Y' to the animate prompt, your next prompt will
  369.        be for the direction to animate.  View both, as the different
  370.        directions can have an entirely different effect.  The direction is
  371.        relative, and can/will be different from file to file (dependent on
  372.        how the palette registers were laid out at the time the file was
  373.        created).
  374.  
  375.  
  376.             The next prompt after selecting the direction, will be for you
  377.        to select the palette.  You have 3 choices here, a random palette,
  378.        the default palette, and a plasma palette (based loosely on the demo
  379.        plasma).  Use experimentation here, as different images work better
  380.        with different palette selections.  The random palette will look
  381.        pretty good for just about any image (note:  images with smooth
  382.        palette ranges animate the best).  If the default palette is laid out
  383.        well without many 'holes', this one works well too.  Although, I have
  384.        viewed some images that DO have 'holes' which enhanced the animation
  385.        effect.  The plasma palette is based on a smooth transition of red,
  386.        green and blue and restricts the animation to the first 180 or so
  387.        registers (again, based loosely on the images created by the demo
  388.        plasma).
  389.  
  390.  
  391.              If you select the Default palette, a window will pop up
  392.        prompting your for starting and ending color.  This will be discussed
  393.        in the next section as it is related to registers, but only applies to
  394.        the default palette.
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                                           6
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.              OK, I trust you've kept up with me so far.  Here's where it can
  410.        get confusing.  Your next prompt is for the starting and ending
  411.        register.  If you've selected either the Random or Plasma palette,
  412.        this will tell the program which color register to start the animation
  413.        at, and which to stop it at.  This gives you the ability to animate a
  414.        portion of the image, instead of the entire image.  This works VERY
  415.        well for images that use a smooth palette range in a portion of the
  416.        picture.
  417.  
  418.  
  419.              Now, if you've selected the Default palette, your start and end
  420.        registers take on additional meaning in conjunction with the start and
  421.        end color window that popped up after you selected DEFAULT.  To give
  422.        you a better understanding, picture your image like this.  Every pixel
  423.        gets its color from one of 256 palette registers.  The start and end
  424.        registers are exactly that, PHYSICAL registers in the machine.  The
  425.        start and end colors are the color data contained in those registers. 
  426.        When you select your start and end register, you are selecting the
  427.        physical registers that are scrolled.  When you select the start and
  428.        end color, you are selecting the range of color data that you want
  429.        scrolled through those registers.  If you select a color range smaller
  430.        than the palette range, the number of colors you selected will
  431.        determine the number of registers scrolled.  However, if you select a
  432.        smaller range of registers than colors, then the registers will scroll
  433.        through the entire range of colors you selected
  434.  
  435.  
  436.  
  437.              OK, are you thoroughly confused?  I thought so, but experiment a
  438.        little after reading the docs (preferably with the images that came
  439.        with the PicView file since they have smooth palette ranges, it makes
  440.        it clear sooner what exactly is going on).
  441.  
  442.  
  443.  
  444.        Command Line Option Summary
  445.  
  446.            -25 or /25 Start menu mode in 25 line mode.
  447.            filespec   Bypass menus and display single file.
  448.            /r         When single file specified, exit PV with graphics 
  449.                       intact.
  450.            @listfile  Display filenames in list file continuously.
  451.  
  452.  
  453.        Hot keys
  454.            
  455.            F3 - Pops up screen size selection window.
  456.            F4 - Pops up animate window.
  457.            F5 - Brings up PalView for selected file.
  458.            F6 - Displays the dimensions of the highlighted file.
  459.            Alt D - Deletes the highlighted file from your drive.
  460.            
  461.            The 'A' key while viewing a picture will cause animate to start
  462.            using the defaults, or the last selections made when you last
  463.            turned animate on.
  464.  
  465.  
  466.  
  467.  
  468.                                           7
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.                                      SHAREWARE
  478.  
  479.  
  480.        PicView is a shareware product.  You are granted a limited 15 day
  481.        noncommercial use of this product. At the end of this period, if you
  482.        are still using PicView, you may license PicView for noncommercial use
  483.        on one machine by sending $15.00 to:
  484.  
  485.        Greg Thomas & Brad Mettee
  486.        c/o Greg Thomas
  487.        P.O. Box 5244
  488.        Balto., Md. 21224-0244
  489.  
  490.        PicView may be licensed for commercial use on up to 5 computers for
  491.        $50.00. A commercial site is defined as, but not limited to, a
  492.        business or individual seeking to make a profit by distributing
  493.        PicView as part of a package, either hardware or software, use of
  494.        PicView as demo to sell hardware or software.  If PicView is
  495.        distributed as part of a package, notice MUST be given to the
  496.        purchaser that they are not a licensed user.
  497.  
  498.        Commercial site's requiring more copies, may contact the authors for
  499.        special pricing arrangements.
  500.  
  501.        All rights are reserved.
  502.  
  503.        PicView may not be changed, modified or reverse engineered in any way
  504.        except by the authors.  PicView may be freely distributed as long as
  505.        it remains in its complete form.  Regardless of how the copy is 
  506.        obtained, all users are required to comply with the licensing
  507.        agreement.
  508.  
  509.        All warranties are  disclaimed, including damage to hardware and/or
  510.        software from use of this product.  In no event will the authors be
  511.        liable for any damages, including lost profits, lost savings or other
  512.        incidental or consequential damages due to your use or inability to
  513.        use the program, or any other claim by any other party.
  514.  
  515.        Any suggestions or comments can be mailed directly to me, emailed to
  516.        me on CIS (user 73047,57) or left on my BBS:
  517.  
  518.                                     Jolly Roger
  519.                                    (301)675-2566
  520.                                    3/12/2400 baud
  521.  
  522.        GIF and Graphics Interchange Format are trademarks of Compuserve, a
  523.        H+R Block Co.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.                                           8
  537.  
  538.  
  539.  
  540.  
  541.